home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3 / complib / cptsv.z / cptsv
Encoding:
Text File  |  1998-10-30  |  3.0 KB  |  133 lines
  1.  
  2.  
  3.  
  4. CCCCPPPPTTTTSSSSVVVV((((3333FFFF))))                                                            CCCCPPPPTTTTSSSSVVVV((((3333FFFF))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      CPTSV - compute the solution to a complex system of linear equations A*X
  10.      = B, where A is an N-by-N Hermitian positive definite tridiagonal matrix,
  11.      and X and B are N-by-NRHS matrices
  12.  
  13. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  14.      SUBROUTINE CPTSV( N, NRHS, D, E, B, LDB, INFO )
  15.  
  16.          INTEGER       INFO, LDB, N, NRHS
  17.  
  18.          REAL          D( * )
  19.  
  20.          COMPLEX       B( LDB, * ), E( * )
  21.  
  22. PPPPUUUURRRRPPPPOOOOSSSSEEEE
  23.      CPTSV computes the solution to a complex system of linear equations A*X =
  24.      B, where A is an N-by-N Hermitian positive definite tridiagonal matrix,
  25.      and X and B are N-by-NRHS matrices.
  26.  
  27.      A is factored as A = L*D*L**H, and the factored form of A is then used to
  28.      solve the system of equations.
  29.  
  30.  
  31. AAAARRRRGGGGUUUUMMMMEEEENNNNTTTTSSSS
  32.      N       (input) INTEGER
  33.              The order of the matrix A.  N >= 0.
  34.  
  35.      NRHS    (input) INTEGER
  36.              The number of right hand sides, i.e., the number of columns of
  37.              the matrix B.  NRHS >= 0.
  38.  
  39.      D       (input/output) REAL array, dimension (N)
  40.              On entry, the n diagonal elements of the tridiagonal matrix A.
  41.              On exit, the n diagonal elements of the diagonal matrix D from
  42.              the factorization A = L*D*L**H.
  43.  
  44.      E       (input/output) COMPLEX array, dimension (N-1)
  45.              On entry, the (n-1) subdiagonal elements of the tridiagonal
  46.              matrix A.  On exit, the (n-1) subdiagonal elements of the unit
  47.              bidiagonal factor L from the L*D*L**H factorization of A.  E can
  48.              also be regarded as the superdiagonal of the unit bidiagonal
  49.              factor U from the U**H*D*U factorization of A.
  50.  
  51.      B       (input/output) COMPLEX array, dimension (LDB,N)
  52.              On entry, the N-by-NRHS right hand side matrix B.  On exit, if
  53.              INFO = 0, the N-by-NRHS solution matrix X.
  54.  
  55.      LDB     (input) INTEGER
  56.              The leading dimension of the array B.  LDB >= max(1,N).
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. CCCCPPPPTTTTSSSSVVVV((((3333FFFF))))                                                            CCCCPPPPTTTTSSSSVVVV((((3333FFFF))))
  71.  
  72.  
  73.  
  74.      INFO    (output) INTEGER
  75.              = 0:  successful exit
  76.              < 0:  if INFO = -i, the i-th argument had an illegal value
  77.              > 0:  if INFO = i, the leading minor of order i is not positive
  78.              definite, and the solution has not been computed.  The
  79.              factorization has not been completed unless i = N.
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.